home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / music2 / melody21.exe / MELODY21.EXE / TECH.DOC < prev    next >
Text File  |  1992-07-26  |  9KB  |  219 lines
  1.  
  2.       
  3.       
  4.                      M E L O D Y    M A S T E R
  5.                            Version 2.1
  6.       
  7.       
  8.       
  9.                   =================================
  10.                        P r o g r a m m e r s'
  11.                   M u s i c   S u p p o r t   K i t
  12.                   =================================
  13.  
  14.  
  15.  
  16.                Copyright 1991-92 by Alexei A. Efros, Jr.
  17.                          All Rights Reserved.
  18.       
  19.       
  20.       
  21.  
  22.  
  23.     INTRODUCTION
  24.       
  25.  
  26.       When Melody Master was conceived, the idea was to develop a
  27.       utility that would help programmers use the IBM PC's internal
  28.       speaker to add music to their programs.  Melody Master can
  29.       hardly be called a "utility", but the goal has been reached.
  30.       Melody Master helps to create music using standard notation
  31.       on a musical staff.  The output can be saved in any of 17
  32.       different music formats!  The program does not require music-
  33.       writing expertise.  Over 100 melodies are included.
  34.                                                            
  35.                           
  36.  
  37.     HOW TO GENERATE MUSIC
  38.       
  39.  
  40.       To generate music with Melody Master, load (or enter) the tune
  41.       you want to use.  Select a tempo and style.  Press F7 and choose
  42.       the format you wish to use.  Melody Master will create a music
  43.       file in the current directory.  The file will have the same name
  44.       as the tune that was loaded plus an extension (.pas, .bas, .dat,
  45.       and so on).  The file may now be copied into any other program.
  46.  
  47.       If the music is not completely satisfying the first time, return
  48.       to Melody Master and change some of the musical parameters such
  49.       as tempos, styles, and octaves.  Some formats cannot play very
  50.       high notes; it may be helpful to move everything down one octave.
  51.       (Use F9, Miscellaneous Utilities and the "8 down" command.)
  52.  
  53.       NOTE: To use Melody Master output files in for-profit software,
  54.       a Commercial License is required (see Registration).
  55.       
  56.       
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.     MUSIC FORMATS OVERVIEW
  66.  
  67.       
  68.       The following chart contains a comparison of the music formats
  69.       available with Melody Master.  Formats are compared by quality
  70.       of music, size if executable, and the applications required.
  71.  
  72.  
  73.  
  74.  
  75.       Name      |Quality|  Size | Application(s)
  76.  
  77.       ================================================================
  78.  
  79.       TP proc.  | great | worst | Turbo Pascal 4.0+
  80.       ----------------------------------------------------------------
  81.       TP array  | great | good  | Turbo Pascal 4.0+ and PLARRAY.PAS**
  82.       ----------------------------------------------------------------
  83.       TP back-gr| avg.# | great | Turbo Pascal 4.0+ and SOUNDER.PAS**
  84.       ----------------------------------------------------------------
  85.       TP play   | good  | great | Turbo Pascal 4.0+ and MUSIC.PAS**
  86.       ----------------------------------------------------------------
  87.       C         | good  | poor  | C and TONE.C**
  88.       ----------------------------------------------------------------
  89.       C back-gr |great #| good  | C, PLAYBG.C** and SOUNDSYS.C**
  90.       ----------------------------------------------------------------
  91.       Turbo C   | great | poor  | Turbo C/Borland C++
  92.       ----------------------------------------------------------------
  93.       BASIC     | good #| great | GW-BASIC,QBASIC,QuickBASIC, etc.
  94.       ----------------------------------------------------------------
  95.       Data File | great | avg.  | PLAY.EXE**
  96.       ----------------------------------------------------------------
  97.       SPKR.SYS  | poor #| avg.  | SPKR.SYS**
  98.       ----------------------------------------------------------------
  99.       ANSI      | good  | great | QModem*,ANSIplay*,A_TYPE*,etc...
  100.       ----------------------------------------------------------------
  101.       ASCII     | good  | best! | VMUSIC*, POLY*, etc.
  102.       ----------------------------------------------------------------
  103.       Norton BE | poor  | poor  | Norton Utilities
  104.       ----------------------------------------------------------------
  105.       SPKRDRV.  | great#| good  | SPKRDRV.SYS*
  106.       ----------------------------------------------------------------
  107.       PianoMan 3| good  | great | PIANOMAN 3.0*
  108.       ----------------------------------------------------------------
  109.       PianoMan 4| good  | great | PIANOMAN 4.0*
  110.       ----------------------------------------------------------------
  111.       4DOS/NDOS | aver. | good  | 4DOS* / NDOS from UN 6.0
  112.       ================================================================
  113.  
  114.       #  - Plays music in background.
  115.       *  - Available as Shareware or Public Domain
  116.       ** - File is included in the Melody Master package.
  117.       
  118.                          
  119.       
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.     MUSIC FORMATS
  128.                                                                
  129.       
  130.       "TP proc." - Turbo Pascal procedure.  Can be called from your
  131.       program. Requires a CRT unit. Use only with short tunes.
  132.  
  133.       "TP array" - Constant array. Must be included in PLARRAY.PAS
  134.       unit using {$I filename} directive. Place PLARRAY in your
  135.       program and call PlayArray (style) procedure.
  136.  
  137.       "TP  back-gr"  -  Constant array.  Must  be  used  with  Nels
  138.       Anderson's SOUNDER.PAS unit. Plays music in the background.
  139.            
  140.       "TP play" - Turbo Pascal procedure. Must be used with a
  141.       MUSIC.PAS unit included in the package.
  142.  
  143.       "C"  -  C function.  TONE.C must be included.  The playing
  144.       speed will vary from computer to computer.
  145.  
  146.       "C  bck-gr" - Global array. Plays music in background. Uses P/D
  147.       routine SOUNDSYS.C. A sample function PLAYBG.C is provided  to
  148.       help  you  understand  how  it works. Also can be used to play
  149.       music foreground.
  150.  
  151.       "Turbo C" - Turbo C function.  Can be called from your program
  152.       to play music.  Use only with short tunes.
  153.  
  154.       "BASIC"  - BASIC program in ASCII.  The "Tn" and "M" directives
  155.       may be changed.
  156.  
  157.       "Data File" - ASCII text file.  Use PLAY.EXE to play in DOS.
  158.       Several melodies may be included in one data file.  PLAY.EXE
  159.       can play all melodies, a specified melody, or random melodies.
  160.       Great for batch files!  See PLAY.EXE for more details.  The
  161.       music file will have a .dat extension.
  162.  
  163.       "SPKR.SYS"  -  ASCII file.  SPKR.SYS must be installed in the
  164.       CONFIG.SYS file.  Copy the generated file into SPK.  Music will
  165.       play in the background.  Long tunes use many files of the same
  166.       name with different extensions (.spk, .sp1, .sp2, and so on).
  167.  
  168.       "ANSI" - ANSI music file. Contains screen and music codes in [MF
  169.       notation. Recommended for long music pieces. Extension '.ANS'.
  170.       
  171.       "ANSI-BBS" - ANSI music file. Contains screen and music codes in
  172.       [M notation specificly for putting short music pieces into BBS
  173.       screens. Extansion '.BBS'.
  174.      
  175.  
  176.  
  177.       
  178.       
  179.       "ASCII" - ASCII file of BASIC PLAY codes without the PLAY
  180.       command. Can be used for different applications. Extension '.ASC'.
  181.  
  182.       "Norton BE" - Must be called by BE BEEP filename. BE is a
  183.       command in Norton Utilities. Extansion '.be'.
  184.  
  185.       "SPKRDRV." - SPKRDRV.SYS must be installed in the CONFIG.SYS
  186.       file.  Copy the generated file into SPK.  The music will play
  187.       in the background.  There is no limit on size! GREAT!
  188.  
  189.       "PianoMan 3" - produces *.MUS files for use with PIANOMAN 3.
  190.       "PianoMan 4" - produces *.MUZ files for use with PIANOMAN 4.
  191.  
  192.       "4DOS/NDOS" - Batch file fragment for use in the 4DOS or NDOS
  193.       environment. (NDOS is a part of Norton Utilities 6.0).
  194.       
  195.       
  196.       
  197.  
  198.     ANSI MUSIC PROBLEM
  199.       
  200.       
  201.       So-called ANSI music consists of a set of codes that are
  202.       primarily used in communications.  ANSI music is not related
  203.       to ANSI organization.  The general structure is as follows:
  204.       
  205.            ESC[MF ...music codes... ^N
  206.                        or
  207.            ESC[M ...music codes... ^N
  208.                                                    
  209.       The music codes are the same as in BASIC's PLAY statements.
  210.  
  211.       These codes are recognized by many popular communication
  212.       software programs such as QModem and Deluxe2. The problem is
  213.       that ANSI music is NOT supported by the ANSI.SYS driver.
  214.       Therefore, it cannot be heard using the DOS TYPE command. For
  215.       more information on ANSI music in the BBS world you may contact
  216.       Linda Bloom, the SYSOP of Bloomunit BBS with your modem at
  217.       407-687-8712. She is an expert in ANSI music and the author of
  218.       "BBS ANSI music tutorial".
  219.